docs: let the structure lead and recenter the landing page on the runtime + standard#56
Merged
Merged
Conversation
Drop the explicit 'five jobs' framing across docs, README, and the landing page — keep write/feed/run/steer/share as the underlying structure without naming it as a concept nobody recognizes yet. Remove the noisy info/callout boxes, fold the high-signal bits into prose, and cut the prerequisites and pip/pipx alternatives in favor of uv. Add a directory file tree and a clear args subsection in Getting Started. Recenter the landing page on Ralphify as the runtime for loop engineering that runs the open ralph loops standard, and remove dead cookbook/blog/agents links and the wrong 'ralph init' command. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Deploying with
|
| Status | Name | Latest Commit | Preview URL | Updated (UTC) |
|---|---|---|---|---|
| ✅ Deployment successful! View logs |
ralphify-co | c32e264 | Commit Preview URL Branch Preview URL |
Jun 08 2026, 06:27 PM |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Follow-up to #55. Removes the explicit "five jobs" jargon, cuts noise from the docs, and gives the landing page a makeover centered on Ralphify as the runtime for loop engineering that runs the open ralph loops standard.
Docs
index.md,cli.md,404.md, andREADME.md. Write → feed → run → steer → share stays as the underlying structure, just no longer named as a concept nobody recognizes yet (headings, numbered cards, and cross-links all updated).!!!/???admonitions) in Getting Started and the CLI reference. High-signal bits (args, the frontmatter-restart gotcha, troubleshooting checklist) folded into prose; pure noise cut.argsinto its own worked subsection.Landing page
ralph init→ralph scaffold; deaddocs/agents/→docs/cli/#using-different-agents; removed deaddocs/blog/links; dropped the pip/pipx install note.Checks
ruff check .passesmkdocs build --strictpasses🤖 Generated with Claude Code